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Playback 1: Business data, 
services, and coaches 
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This unit covers Playback 1. Playback 1 builds upon the foundation that is established in 
Playbacks 0. The next piece of the puzzle is to concentrate on business data. It is the data that 
users view and input into web pages when they complete their tasks. 
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Unit objectives 


° Build a business object 

° Initialize a complex object and a list 

° Build a service 

¢ Use coaches to define and implement guided user interactions 
¢ Implement a service for an activity in a process 


Map variables between a nested service and an activity in the overlying 
process 


Describe the object methods 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


After completing this unit, you should be able to: 

Build a business object 

Initialize a complex object and a list 

Build a service 

Use coaches to define and implement guided user interactions 

Implement a service for an activity in a business process 

Map variables between a nested service and an activity in the overlying process 
Describe the object methods 
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Training 


Playback 1: Business data and services 
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° The goal is to 
demonstrate data flows 
from one coach to 
another, and from one 
task to another inside 
the process 


All data is bound on the 
coaches, and if the 
same data is shared 
across multiple tasks, 
Playback participants 
can see the data move 
through the different 
activities 
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Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


The goal is to demonstrate data flows from one coach to another, and from one task to another 
inside of the process. All data is bound on the coaches, and if the same data is shared across 
multiple tasks, Playback participants can track the data when it moves through the different 
activities 
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Training 


Topics 


* Creating a data model 

° Building services 

° Building coaches 

¢ Implementing services in a process 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


This unit covers the following topics: 

e Creating a data model 

e =Building services 

e Building coaches 

e Implementing services in a process 
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Key concepts in this unit 


¢ Playback 1: Business data and services: To demonstrate data flows 
from one coach to another, and from one task to another inside of the 
process 

* Business objects: Are used to represent the business data that is 
relevant in the context of your business process 


© Coach: The user interfaces for human services 


° Services: Made up of steps that define what happens when service 
(task) activities are triggered in a process 

¢ Data mapping: Is used to map the input and output variables of the 
service to variables in the process so that runtime variable values can 
be passed to and from the service 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


This slide lists the key concepts in this unit. 
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Creating a data model 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


First topic: Creating a data model. 

Until now, simple variables are implemented to drive process flow. Process flow data is only part 
of the data necessary for the process to function correctly. Much of the process flow data is 
derived from or dependent upon business data. In this Playback, the project development team 
defines the business data model for the process. 
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Defining the business object data model 


° Business objects are used to represent the business data that is 
relevant in the context of your business process 
° Create a data model that accurately reflects the business data and its 


structure 
= Do not be influenced by existing logical or physical data models 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


Business objects are used to represent the business data that is relevant in the context of your 
business process. Create a data model that accurately reflects the business data and its 
structure. Do not allow external elements to influence or affect the development of your process 
business object variables that belong in your data model. 
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Building a complex business object 


® HiringRequisition ~  @ @ Last upeated seconds apo by you 


° When the system data toolkit or 
other business objects do not 
match the specifications, create a 
custom business object 


° Create rules about complex data 
that is nested or hierarchical 


Playback 1: Business data, services, and coaches ®© Copyright |BM Corporation 2019 


When the system data toolkit business objects cannot meet your requirements, you can create 
custom business object types. You can create a custom business object type by using a base 
business object type or by defining a new complex structure. 


You can create rules about complex data that is nested, or hierarchical. Data that is referenced 
within the text of a rule is not limited to simple object types such as string, integer, or date. You 
can create complicated rules with nested object structure. Click Add and create the complex 
object that is made from simple or other complex object types. 
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Building the data model 


After you define the data, organize your data into different logical units: 
° Some organization is obvious, but other data is more difficult to organize 
° Look to existing data models in your company for ideas 


¢ Example of a business object: A structure that contains multiple elements, all 
pertaining to the same “subject,” which is what the structure represents 
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Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


After you define the data, organize your data into different logical units. An example might be a 
street address, city, and state that becomes a unit that is called address. Some organization is 
obvious, but other data is more difficult to organize. Look to existing data models in your company 
to help you create the object. 


An example of a business object is a structure that contains multiple elements all pertaining to the 
same “subject”. It is modeled after what the structure represents (for example, a name and phone 
number would be relevant to an employee). There is a mixture of art and science to create good 
complex objects, but keep in mind simplicity and reuse when you create these objects. Do not 
bog down your complex objects with elements that might never be used, even if other objects in 
the organization might include those elements 
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Standardizing the variable naming convention 


° Business objects begin 


with an uppercase letter 


° If the business object ¥ ® Parameters @* 
consists of more than one © requisitionNumber (String) 
word, capitalize the first @ dateORequest (Date) 
letter of each word © requester (String) 


© datePostionwnlable (Date) 


Variables and business 


z wo e st 
objects are case-sensitive Aa agi 


© tmangComenents (Stnng) 


° In this example, the 
position variable uses © jobtate (Stnng 
the business object type © jdt 
Position @ 
@n 9 
v © compensatonl Is (CompensationDetails) 


@ sal 
@ bon unt 


» © cepatmentDetails (DepartmentDetails) 
» © recritingDetails (RecruitingDetails) v 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


Business object type names begin with an uppercase letter. Adopt this convention to differentiate 
variables and business object types. If the business object type name consists of more than one 
word, capitalize the first letter of each word. In the example that is provided on screen, the 
position variable uses the business object type Position. Variables and business objects are 
case-sensitive. 
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Refactoring 


¢ Limited refactoring support for the following cases: 
= Business object rename in processes and services 
= Business object attribute rename in processes and services 
= Local variable rename in the specific process and related services 


Rename Artifact 


Enter the new name of the artitact 


Name: |HngRequstion 


FINISH | | CANCEL | 


Playback 1: Business data, services, and coaches ®© Copyright |BM Corporation 2019 


Over time, applications change and business objects, their attributes, and variables might be 
renamed. However, many parts of a business process might reference or have a dependency on 
a business object, an attribute, or a variable. Therefore, renaming any object can produce 
unexpected results. 


For instance, suppose you created an object type address that contains city, state, and postal 
code elements. Later on, your company goes international and wants to specify the current object 
as a US address and add other addresses that belong to other countries. If you change the object 
name, anything that references the original address object throws an error, and you must 
manually parse through all the objects in your process application to correct the errors. 
Refactoring offers a one-step process to update references to the changed variable name. When 
you use the combination Alt + Shift + R to rename an object, a rename window opens and guides 
you through targeting all the things in the library that use the old object’s name. 

Refactoring applies to: 


e Renaming objects in processes and services 
e Renaming attributes in processes and services 
e Renaming local variables in a process and its related services 


Refactoring is available to those objects referenced under the Variables tabs in the processes 
and services in your Process Application. Unfortunately, one limitation is that any JavaScript code 
found in coaches are not updated. 
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Complex objects and lists 


° You can declare any variable to be a list, or an array, of a business 
object type 
= Instead of containing only one instance of the type declared (String, 
Date, or Integer), your variable holds many of the same business object 
types 
° All complex business objects and all lists (arrays) must be 
initialized before you use them in a process or service 
= If your business object type includes elements that are themselves 
complex business object types other than the simple types, then you 
must initialize them before you use them 
= You must also initialize lists before you use them, by using .listOf 


Y Parameter Properties 


Name: recruitingDetails 
Variable Type ® RectuitingDetails Hiring Requisition Toolkit [ Select. | 
Documentation: BIUVU|Z=SZSZZlE fle & 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


You can declare any business object to be a list or an array, of a business object type. Instead of 
containing only one of the types declared (String, Date, Integer), your variable can hold many of 
the same business object types. Therefore, if you wanted to create a variable that contained 
multiple Integers, you might create a Private variable list of type “Integer”. 


To create a list variable, check the check box next to “Is List:”, and the variable will add the “(List)” 
designator after the business object type in the variables list. 


After you create the list variable, you must initialize the variable before you can use it by using. 
listOf. 
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Initializing complex objects and lists 


¢ All complex business objects and all lists (arrays) must be initialized 
before you use them in a process or service 


° Before using a complex business object, initialize it by using a script like 
the following script: 


tw. local. requisition=new tw.object.Requisition(); 


¢ You must also initialize lists before you use them, by using .listOf 
tw.local.yourStringList = new tw.object.listOf.String(); 


¢ Then, you add elements to the list: 
tw.local.yourStringList[0] = "First Element"; 
or 


tw. local. yourStringList.insertIntoList( 
tw.local.yourStringList.listLength, "First Element"); 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


In IBM Business Automation Workflow, all complex variables and all lists (arrays) must be 
initialized before you use them in a process or service. Before you use a complex variable, 
initialize it by inserting the JavaScript that is shown into a server script object. Server scripts are 
explained later in this unit. 


As you can see, the name of the variable that is being initialized is tw.local.requisition. The 
name of the complex business object type is Requisition. 


Your business object type might include elements that are themselves business object types 
other than the simple types (sting, date, integer). You must initialize those sub-objects as well 
before you use them. 


You must also initialize lists before you use them by using .listOf. This approach works for simple 
and complex business object types. If you have a list of Strings, you can initialize them using a 
script as shown by the example. 
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Nested processes and variables 


¢ Asubprocess has access to the data of the parent process 
= Data mapping is not required to pass data into or out of the subprocess 


= You can also declare private variables within the subprocess that are not 
visible to the parent process 


. 


/ <~ 
oe Feereved Apress ia > Request Compliant 


Is Request | a Is Request 
of Approved Compliant 


< 


° Linked processes require input and 
output variables in the nested 
process and variable mapping from 
the parent process 
= The variables must be of the same 

variable type when mapping 


General 


v Activity Type 


Implementation 


Data Mapping 


Type: 
Linked Process 
Pre & Post 


Playback 1: Business data, services, and coaches ®© Copyright IBM Corporation 2019 


Developers must be careful to consider how variables are passed between the parent and the 
nested process when you use nested processes. Subprocesses, event subprocesses, and linked 
processes handle variables differently. A subprocess has access to the data of the parent 
process, and data mapping is not required to pass data into or out of the subprocess. You can 
also declare private variables within the subprocess that are not visible to the parent process. 


Event subprocesses are just a special type of subprocess, and variables that are defined in the 
parent process are accessible by the subprocess. An event that occurs in the parent process 
triggers an event subprocess. It is not just a step in the process as part of the process flow. 


Linked processes require developers to create input and output variables in the nested process 
and to map variables from the parent process to the linked process. The variables must be of the 
same variable type when mapping. 


If you are debugging a process and find variables that are not available in a process or service, 
check whether the variables must be explicitly passed. If so, check whether the variables are 
mapped correctly. 
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Sharing a complex business object 


* Custom business objects in a process application are available for all 
processes and services that are included in the process application 

° Share custom business objects across process applications through 
toolkits 

° If the business object and its values must be accessible to other 
instances at run time, check the shared object check box in the 
Behavior section of the Business Object interface 
= Shared business objects apply only to a complex type 


« The data within a shared business object is shared between business 
processes and tasks 


¥ Common Behavior 


Name HinngReguisition Complex type 
Modified AS , 


Documentation 


] 
Ras | 
" 
tht 
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Playback 1; Business data, services, and coaches ® Copyright IBM Corporation 2019 


When you create a custom business object in a process application, that object is available for all 
processes and services included in the process application. If you want to share a custom 
business object across process applications, create or store the custom object in a toolkit. Then, 
create a dependency on that toolkit from the process applications that require the variable. 


Use the Shared Object check box if the business object and its values must be accessible to 
other instances at run time. It designates that the data must be shared. The business object 
becomes a shared object. Shared business objects apply only to a complex structure type. The 
data within a shared business object is shared between business processes and tasks. 


The data within a shared object is persisted to the database when: 


e The shared object is created 
e The business process or task is persisted to the database 
e When the JavaScript method save() is done on the shared business object 
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Building services 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


Topic 2: Building services. 


After modeling the business process, it is time to think about these processes as sets of 
interactions. The goal of this Playback involves building interactions. 


These interactions represent a critical piece of Business Process Management (BPM). Instead of 
focusing solely on the chains of activities with their sets of inputs and outputs, think about the 
protocols and agreements that are made between the users. 


Services provide a strategy for choreographing these protocols and agreements. Choreography is 
an abstract notion of process. It is used to describe the interactions of collaborating entities, each 
of which can have its own internal orchestration (modeling) processes. 
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What are services? 


>  SetSQL SQL Execute... ~O 
5 End 


wa 
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Playback 1; Business data, services, and coaches 


Services are made up of steps that define what happens when service (task) activities are 
triggered in the process. Each step enables the service to do a different job, from integrating with 


an external data source to generating forms, or coaches. 


© Copyright IBM Corporation 2019 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


ZB828 Unit 6 Transcript 


Slide 18 


Training 


Creating services 
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oa - 
—* 
% ( > sat So > Sot Parameter SOL Execute ~O ly 
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Playback 1: Business data, services, and coaches ®© Copyright |BM Corporation 2019 


The IBM Process Designer is where authors build reusable services that implement the activities 
in a process definition. When you use the Process Designer, services differ from processes in 
that there are no swimlanes, but the interface is similar to creating processes. The service palette 
on the right is customized with what items you can use to build the service. 

When creating a service, developers give them human-readable names. They use spaces 
between the words so other developers can understand what this service does. Name the service 
after the activity that the service does so developers can identify its function without having to 
open the service in the IBM Process Designer application. 
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Building coaches 


Playback 1: Business data, services, and coaches ®© Copyright |BM Corporation 2019 


Topic 3: Building coaches. 


A human service presents a web form for a process participant to interact with. This web form in 
IBM Business Automation Workflow is an HTML page that is called a coach. This topic covers the 
fundamentals of building coaches, and enables developers to create coaches in a short amount 
of time. 


During this part of the Playback, developers do not look to alter the appearance or add any extra 
functions to their coaches. Developers concentrate on creating forms that can be filled out and 
ensuring that data is posted back to the server. The process gathers all the necessary data from 
the users in the process to complete the overall process. 
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Coach overview 


° Coaches are the web-based user interfaces that provide process- 
related data to Process Portal users and collect input from those users 


° Coaches are implemented in the client-side human services, which 
manage the flow from one coach to another 


Two types of user interface are available for human services: 

= Task completion 

= Stand-alone services (dashboard, a startable service, or a URL service) 
Coaches provide a way for team members to input business and 
process data into the process in a dashboard or task completion 
Coaches provide a wizard-like approach for team members to complete 
their tasks 

The coach is rendered in a browser for the business user when the 
coach service (the process activity of the participant) is run 

Similar to building processes and services, developers use a 
WYSIWYG interface to build coaches by dragging objects from a widget 
palette onto the coach designer canvas 


Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


Coaches are the user interfaces for human services. You have two types of user interfaces for 
human services: task completion and stand-alone services. A task completion user interface 
implements a specific activity within a process instance. It has access to the details of that 
process instance. A stand-alone service can be a dashboard, a service, or a URL service. A 
dashboard is a stand-alone user interface that users can run at any time. Users can access 
dashboards through the Process Portal. A service can be started in Process Portal at any time, 
whereas a URL service can be started directly through the URL. 


How can users input the data necessary to accomplish their task inside of a process? Coaches, 
or a standard web page brought up in the user’s browser, are used to gather the necessary data 
for users to complete their tasks. Developers build coaches that provide a wizard-like approach 
for process participants to complete their tasks. 


When an activity on a process is assigned to a team or a user, a coach is rendered in the browser 
to allow the user to provide the process the necessary data to complete the task. 


Building a coach is similar to building processes and services and uses a “what you see is what 
you get’, or WYSIWIG interface. When the coach is then rendered for the user, the development 
view is similar to what the user uses. Therefore, developers do not need to be HTML experts to 
create basic forms 
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Build user interface for human services by using coaches 


° To build the user interface for human services in the Process Designer, you 
use coaches 

® Coaches can contain coach views, also known as views 
» Aview is a reusable unit that you use in coaches and other coach views 

° Aview generally defines the user interface for a particular type of data, 


giving you the potential to customize the user interface by specifying the 
configuration options 


sun 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


The UI toolkit contains a set of (coach) views for designing applications that can run on multiple 
device types, such as mobile and desktop devices. All the views in the UI toolkit are suitable for 
use on both desktop and mobile devices. 


Each view points to a specific set of files: A JavaScript file that provides the behavior of the view. 
Image files to represent the view on the palette and on the canvas. A preview JavaScript file that 
shows a preliminary image of the view when it is dropped on the coach editor palette. The view 
can also have other files such as CSS and LESS files for styling, localization files, and other 
control-specific resource files, but these additional files are optional. Views are covered in more 
detail in the next Unit. 
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¢ Agrid is a container that is 12 units wide 


= Acontainer groups related cells 
= Cells are placeholders for content 


Select a Template 


O Start with a default coach 


lees cy } 
O Select template: i Single Column_| Task Template V 
| == Two Columns | 


| Hf Three Columns 
|| Mosaic 


Laying out a coach by using the grid layout 


¢ You can lay out a coach by using cells in a grid 


= The actual width of each unit is variable and depends on the screen size 
¢ Within a grid, you can have containers and cells 


|B Header Footer 


OK 


| CANCEL 


Playback 1; Business data, services, and coaches 


You can lay out a coach by using cells in a grid 


A grid is a container that is 12 units wide 
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The actual width of each unit is variable and depends on the screen size 


Within a grid, you can have containers and cells 


The grid layout feature is useful when building your coach. 
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The coach designer interface 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


Coaches are web-based forms or dashboards that a developer builds for business users to 
complete the tasks or follow process or task performance metrics that are assigned to them at run 
time. All development occurs inside a web browser, so developers have a “what you see is what 
you get” (WYSIWYG) view of the rendering of the coach. 


Coaches are made of up of views and controls. The view provides the user interface elements 
and layout for the coach through sections and controls. Each view can contain one or more 
views, which creates a parent-child relationship between these views. At run time, the parent view 
is rendered as a <div></div> tag that contains a nested <div></div> tag for each child view. Each 
view also has a binding function to use data values from a business object, CSS code to control 
its visual layout, and JavaScript to define its behavior. More information on views is covered later 
in the next unit. 
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Panels 
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e Views contain a group of views or controls, or both (other views) 


Playback 1: Business data, services, and coaches ®© Copyright |BM Corporation 2019 


Views that are panels contain a group of panels or controls or both (other views). Panels control 
the layout of your controls after they are rendered in the browser. The controls are made of HTML 
div and span sections. To add a panel, click an existing component to open the highlight. Click 
the plus (+) sign on the highlight to open the palette. Select the Layout tab and select Panel. A 
tabs control is also used to group similar sections. All the panels can be nested within each other. 
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Controls 
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Playback 1: Business data, services, and coaches ® Copyright |BM Corporation 2019 


Controls are objects (or widgets) that are placed directly on the coach designer canvas or in 
sections on the canvas. Controls are Views that include buttons, check boxes, input boxes, date 
time pickers, select controls, and other standard HTML objects. Also, they include a mobile ready 
set of control objects that are formatted for a mobile environment. Although the standard objects 
cover most of a developer's needs, IBM Business Automation Workflow allows developers to 
customize the controls. Controls are customized by using a custom HTML block on the coach 
designer that includes JavaScript, CSS, or custom HTML elements. When the controls are laid 
out, it is easy to copy and paste them into a view to share with other coaches across your 
process application or other installations. 
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View object settings 
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View objects, whether sections or controls, contain settings for use in the coach. The property 


settings are separated into five categories: 


¢ General: Describes the common properties of the object, such as the control ID, and the 
behavior, such as binding and label visibility 


¢ Positioning: Sets the padding, margins, height, width, and overflow of the objects on the 


canvas 


¢ Configuration: Allows developers to modify the configuration attributes of an object 


¢ Events: Define logic to be called based on 
on blur. 


events such as on load, on change, on focus and 


¢ Visibility: Sets the visibility of the object through a variable value, a rule, or a script 
¢ HTML Attributes: Allows developers to add classes and attributes to the HTML objects that 


are rendered in the browser 
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Adding controls from server-side variables 


Requisition Detate Ponition Details Recruting Details Compensation Oetels Department Details 


Requisition Humber 


Requestor 


Date Of Request 


Date Position Available 


Hiring Manager Comments 


There is a quick and easy way to add controls to a coach that are automatically bound to server- 
side variables. The first step is to make sure that you have your simple or complex variables 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


(Input, Private, or Output) defined for your service. 


When you create a coach, you see the variables that are defined for your service are listed on the 
right side. Click and drag your variables onto the coach canvas, and controls are created and 
bound automatically to the variables and any subobjects if you are moving a complex object. 


There might be controls on the coach that control the process flow. Add the process flow 
variables necessary to control the process directly on your coach. It adds an input box that is 
bound to the process flow variable when you run your coach. During the process Playback, you 


can enter the process flow data into that input box to control your gateways. 
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Buttons and sequence flow 
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Next, you need the ability to submit the coach to the server and move the service along. Buttons 
allow the form to post the data back to the server from the client. Developers can model other 
abilities such as saving progress or retrieving external data. 


After you add the wanted buttons to your coach, sequence flow must be connected in the service 
Diagram. Each button requires a new line to be drawn in the diagram. Each button item 
corresponds to one line or flow if the button is configured to have a flow. 


In the slide, a line is sequence flowed from the coach to the End event. There is a button on the 


coach that is called Complete, and another called Postpone task that goes to a postpone event. 
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Setting screen size 
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Configuration 
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Size Resolution 


{} Small — 640 pixels or less 
{J Medium 641 - 1024 pixels 
LJ Large = More than 1024 pixels 


° The controls can respond dynamically 
to three different screen sizes. 
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Process Designer supports three size layouts for user interfaces. 

Use the Positioning tab in the properties for the control to set the size of the control. The settings 
resize the coach to match three different formats: small, medium, and large. These resolutions 
approximate the resolutions for mobile devices, tablets, and desktop displays. 

Screen size settings are as follows: 

¢ Small: 640 pixels or less 

¢ Medium: 641 — 1024 pixels 

¢ Large (default): More than 1024 pixels 
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Implementing services ina 
process 
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Topic 4: Implementing services in a process. In this topic, the activities are implemented with the 
artifacts that were previously built. 
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When you first add an activity to a lane in a process, notice the activity implementation. The 
system automatically implements the activity with a default human service or a default system 
service. To specify what happens when an activity is triggered at run time, you must attach a 
service by using the implementation section in the Properties tab. 


Attach any of the services you create to the activity on the process. When a token flows to this 
activity, the system creates a task, and the user completes the task. The system might also 
complete the designated service. 
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Business objects, variables, and data mapping 


° Business objects 
» Inthe Process Designer, business objects are complex objects that are 
created from simple business objects or other complex business objects 
= Define the business data 


° Variables 
Instantiate business objects that activities use in a business process 
definition or by steps in services, such as integration services or human 
services 
Capture and store the business data 
Each has its own type and scope 
Must be declared before you can start to use them 
° Data mapping 
» Inthe Process Designer, you set the input and output data map to pass 
variables to an activity or a step 
= You must set the input and output mapping for each activity in a process 
= Map variables in the parent process to the variables received and generated 
by nested processes and services 


Playback 1: Business data, services, and coaches © Copyright |BM Corporation 2019 


All Services share the same business objects and instantiate business objects using variables. 
You must set the input and output mapping for each activity in the process. If you are using a 
linked process, you will also need to map variables between the parent process and the linked 
process. 
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Data mapping 


° Data mapping is used to pass the values of variables between an activity 
(task) in a process and a service. 

° When you attach a service to an activity, the Data Mapping section must be 
populated with the input and output variables of that service. 


Overview Definition Variables Folders Views: Tracking 
: = Ls 
a) = 
Wee Trade to - Check for } 
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Data mapping is used to pass the values of variables between an activity (task) in a process and 
a service. When you attach a service to an activity, the Data Mapping section needs to be 
populated with the input and output variables of that service. The Data Mapping section is used to 
map the input and output variables of the service to variables in your process. Runtime variable 
values can be passed to and from the service with these settings. Variables can either be 
automatically mapped to your process variables by pressing the auto-map button, or you can 
manually specify the process variables to be mapped 
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Mapping input and output data for an activity or step 


Data mapping sets the input and output map to pass variables to an 
activity or a step 

Requires a set of declared variables and an activity, or a service that 
contains a set of declared variables and a step 

The activity or step must implement a service or linked process, 
which also contains a set of declared variables 

Set the input and output mapping for each activity in a process 

The subprocesses and services that implement the activities 
generate variable values 

= These variable values map to the variables from the main process 
Auto-mapping works only when variable names and types match 
exactly 

Always use an identical name and data type for a set of input and 
output variables that are passed in, processed, and then passed back 
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When you implement the activity with a service in your library, the input and output variables of 
the service can be mapped at the process level. When the process must send data to the service, 
map the input variable, and when the activity changes or generates the data, map the variable 
back to the process level. 


Auto-mapping works only when variable names and types match verbatim between the 
implementing service inputs and outputs and the variables that are defined at the parent level. A 
good practice is to use identical names and data types for the input and output variables on your 
processes and services. It is only necessary to have identical variable types to map the data, but 
to avoid confusion, you should also match variable names if both variables contain the same 
data. 
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Understanding object methods 


tw. local.myString.toLowerCase(); 


Namespace Object Method 
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All objects inside of IBM Business Automation Workflow have methods that are associated with 
them. If you are familiar with object-oriented programming, then you are familiar with using 
methods on the objects. To access the object methods, you must always first use the object 
namespace followed by the object, and the method you would like to access. 


For example, the JavaScript method toLowerCase might be called on an object of type String. In 
this example, the results of the call are used to convert the value of tw.local.myString to all 
lowercase. Certain times the method affects the object directly, and other times the method 
returns an object that you must map to another object. Use the auto-complete feature when you 
determine how an object method is used, as the system displays how to use the object method. 
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Unit summary 


° Build a business object 

° Initialize a complex object and a list 

* Build a service 

¢ Use coaches to define and implement guided user interactions 
¢ Implement a service for an activity in a process 


° Map variables between a nested service and an activity in the overlying 
process 


° Describe the object methods 
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Having completed this unit, you should be able to: 

Build a business object 

Initialize a complex object and a list 

Build a service in the IBM Process Designer application 

Use coaches to define and implement guided user interactions 

Implement a service for an activity in a process 

Map variables between a nested service and an activity in the overlying process 
Describe the object methods 
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